home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / graphics / fig2mfpic / README < prev    next >
Text File  |  1994-06-15  |  3KB  |  77 lines
  1. README for fig2mfpic 0.24 alpha version, Thu 16 June 1994.
  2. ----------------------------------------------------------
  3. Author:  Geoffrey Tobin.
  4. Email:   G.Tobin@ee.latrobe.edu.au
  5. Address:  Department of Electronic Engineering,
  6.           La Trobe University,
  7.           Bundoora VIC 3083,
  8.           Australia.
  9.  
  10. Purpose:
  11.  
  12. fig2mfpic is a program for converting Fig 2.1 graphics language into
  13. an approximate equivalent in MFpic.  MFpic is a set of TeX and METAFONT
  14. macros for drawings.
  15.  
  16. Current version:
  17.  
  18. fig2mfpic 0.24 alpha is designed for mfpic.tex version 0.2.5 (as at CTAN)
  19. and graphbase 0.2 fig 2a.  The graphbase (0.1.13.1) of mfpic 0.2.5 does
  20. NOT work with fig2mfpic.
  21.  
  22.  
  23. Manifest:  eight (8) files:
  24.  
  25.   296  Jun 10 22:34  Makefile      A make file for the "cc" C compiler.
  26.  2896  Jun 16 13:35  README        This introductory file.
  27.   386  Jun 15 20:03  TODO          What I'd like fig2mfpic to do, in future.
  28. 52714  Jun 16 13:30  fig2mfpic.c   ANSI/traditional C source for fig2mfpic.
  29. 23444  Jun 16 13:33  graphbase.mf  Modified graphbase.mf, version 0.2 fig 2a.
  30. 11511  Oct 12  1993  mfpic.tex     mfpic.tex 0.2.5, from mfpic distribution.
  31.  2233  Jun  2 22:42  tidied.fig    Sample Fig file, every major Fig object type.
  32.  2689  Jun  1 22:08  various.fig   Like tidied.fig, plus unknown object types.
  33.  
  34. Usage:
  35.  
  36. After making fig2mfpic, if you type just the command `fig2mfpic', as:
  37.  
  38.     fig2mfpic
  39.  
  40. then fig2mfpic will issue a usage summary to stderr, as follows:
  41.  
  42. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  43. usage:  fig2mfpic  [infile] [... infile] [> outfile]
  44.     [-?]    Help request
  45.     [-d]    List input file, with line numbers
  46.     [-code=<integer>]    First character's code : not effective
  47.     [-pen=<real>]    Default pen width (pt)
  48.     [-u=<none>]    Output unit name
  49.     [-xscale=<real>]    X unit (in output units)
  50.     [-yscale=<real>]    Y unit (in output units)
  51.     [-xneg=<real>]    Most negative X value (X units)
  52.     [-xpos=<real>]    Most positive X value (X units)
  53.     [-yneg=<real>]    Most negative Y value (Y units)
  54.     [-ypos=<real>]    Most positive Y value (Y units)
  55.     [-top=<real>]    Top of drawing (Y units)
  56.     [-mf=<string>]    Output METAFONT file
  57.     [-tex=<string>]    mfpic TeX drawing macros file
  58.     [-log=<string>]    fig2mfpic log file
  59. If an "infile" is "-", then standard input is read.
  60. The mfpic TeX drawing file goes to standard output.
  61. Messages, such as this, go to standard error.
  62. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  63.  
  64. Typical use of fig2mfpic is exemplified by:
  65.  
  66.     fig2mfpic various.fig > various.tex
  67.  
  68. Error messages are recorded in the log file, which is called
  69. `fig2mfpic.log' unless you give it another name by the -log= option.
  70. If there are no error messages, then the log file has a size of zero
  71. bytes (at least on unix).
  72.  
  73. Impressions and advice are of course welcome.
  74.  
  75. Best wishes!
  76. Geoffrey Tobin
  77.